home *** CD-ROM | disk | FTP | other *** search
/ Aminet 25 / Aminet 25 (1998)(GTI - Schatztruhe)[!][Jun 1998].iso / Aminet / misc / emu / darkNESs0_24.lha / darkNESs0.24.doc < prev    next >
Encoding:
Text File  |  1998-04-01  |  9.0 KB  |  230 lines
  1.  
  2.                               darkNESs v0.24
  3.                        A NES emulator for the Amiga
  4.                           (C)1997-98 Mark Van Hal
  5.  
  6. Introduction : 
  7.  
  8.     darkNESs is a Nintendo Entertainment System emulator for the Amiga.
  9. To use it you will need any Amiga with a 68020+ and OS 2.0+, you will also
  10. need ROM image files for the games that you wish to play. These files must
  11. be in .NES format as is used by iNES, NESticle, and other NES emulators on
  12. the PC and Amiga. Starting with version 0.20 darkNESs is written in 100% asm,
  13. and is much faster then previous versions. Although darkNESs is not the
  14. fastest NES emulator for the Amiga, it is the most compatible, and is the
  15. only one that handles NES games that use bank switching during the display and
  16. properly updates the display with games that don't use VROM. It is also the
  17. only NES emulator that works properly with ECS/OCS and Gfx cards.
  18.  
  19. Using darkNESs : 
  20.  
  21. To use the GUI :
  22.  
  23. From WorkBench : Double click on the darkNESs icon.
  24.  
  25. From the CLI type : darkNESs with no options.
  26.  
  27. The GUI is simple enough that not much of an explanation is required.
  28. Options that are disabled are either not yet implimented or are unavailable
  29. at the current time, these will become enabled when it is appropreate. 
  30. (for example the Start gadget is disabled until a valid .NES file is loaded)
  31. The Screen Mode gadget requires version 39 or better of the asl.library.
  32. When you Quit from the GUI, the settings are stored in the darkNESs.prefs
  33. file in the same directory as the program.
  34.  
  35. Version 0.20 of darkNESs added a line based screen refresh mode to the
  36. tile based mode in earlier versions. This mode works best with games
  37. that make changes to the display on every line (like F1-Race) but is
  38. about 10% slower then the tile based mode. It is best to experiment to
  39. see which mode works best for each game (and you can change the mode during
  40. the emulation by pressing F3)
  41.  
  42. Also new in version 0.20 is Double Buffering, which eliminates screen flicker.
  43. Screen updates are also faster with Double Buffering on.
  44.  
  45. Note : In version 0.24 Double Buffering now works with any screenmode on
  46. the native Amiga display (no Gfx cards) that supports at least 32 colours.
  47. If you turn Double Buffering off darkNESs will work on Gfx cards.
  48.  
  49. If you don't want to use the GUI then, 
  50. from the CLI type : darkNESs file.nes [-(P|O)] [-F] [-D]
  51.  
  52. Replace file.nes with the name of the .nes format ROM image file. If the
  53. cartridge uses battery backed memory, then a file with the same name but
  54. with an extension of .SAV instead of .NES will be created the first time
  55. that you use it, and will be used to save the contents of the battery
  56. backed RAM.
  57.  
  58. The -P or -O options are only of use to NTSC users. Since the NES has a
  59. resolution of 256 x 224, and a standard NTSC LORES screen is 320 x 200,
  60. 24 lines of the NES screen would not normally be visible on the screen.
  61. So, by using the -P option, you can run darkNESs in a PAL LORES screen which
  62. has a resolution of 320 x 256, or you can use the -O option which will use
  63. an NTSC LORES screen with overscan to allow you to display the full NES
  64. screen. Note : If you use the -P option, make sure that the PAL monitor
  65. driver is in Devs:Monitors.
  66.  
  67. The -F option tells the emulator to set the initial frame-skip to 3 (draw 
  68. every third frame). This speeds things up a bit, but some games don't look
  69. as good when doing this. The frame-skip can be adjusted with + and - while the
  70. emulator is running. 
  71.  
  72. The -D option turns double buffering on.
  73.  
  74. darkNESs uses the settings from the darkNESs.prefs file unless the
  75. command line options are specified.
  76.  
  77. Controls : 
  78.  
  79. Once the emulation is running, you can use the following controls : 
  80.  
  81. Cursor Keys - Joypad
  82. LShift or A - Button A
  83. LAlt   or Z - Button B
  84. Return or ] - Start
  85. RShift or [ - Select
  86.  
  87. F1          - Select Controller 1
  88. F2          - Select Controller 2
  89.  
  90. F3          - Toggle between Tile and Line Refresh Methods
  91. F4          - Toggle IRQ interrupts ON/OFF (Mapper 4 only)
  92. F5          - Toggle scroll fix ON/OFF
  93.  
  94. +           - Increase Frame-skip Value
  95. -           - Decrease Frame-skip Value
  96. F10         - Reset (you may have to press F10 twice to reset)
  97. Ctrl        - Toggle Mirroring (Horizontal/Vertical)
  98. Esc         - Exit
  99.  
  100. Problems : 
  101.  
  102. Unable to open Screen - Not enough chip memory or the default screenmode
  103. in your darkNESs.prefs file is not available or you have selected double
  104. buffering and the selected screenmode is not an NTSC or PAL one. If using
  105. the command line options, if you are using the -P option and the PAL monitor
  106. driver is not loaded you will get this message.
  107.  
  108. Not Enough Memory to Load File - There is not enough memory to load the
  109. ROM image.
  110.  
  111. File Not Found error message - The ROM image file you specified cannot be
  112. found.
  113.  
  114. Bad .NES File - The ROM image that you specified is not a valid .NES file.
  115.  
  116. Unsupported Mapper Type - The ROM image that was loaded uses a MMC
  117. (memory mapper) that is not supported by darkNESs. Currently darkNESs
  118. supports the following MMC's : 
  119.  
  120. 0,2,3 - 100% working
  121. 1     - 95%  working
  122. 4     - 90%  working
  123. 7     - 100%  working
  124. 9     - works, but not yet perfect
  125. 11    - 80%  working
  126. 16    - not tested
  127.  
  128. No other MMC's are currently supported.
  129.  
  130. Graphics appear wrong - With ROM images with MMC types 0,2,3 the type of
  131. mirroring that the games uses is stored in the .NES header. If this is
  132. set incorrectly, the graphics may appear wrong. Press Ctrl to change the
  133. type of mirroring, and press F10 to reset the game. If this does not fix
  134. the problem, then it may be that the game is not compatible with darkNESs.
  135. With some games the graphics may be fixed by turning on the scroll fix
  136. (press F5) this may solve the problem, or it may do nothing, or it may
  137. make it worse...
  138. Note : MMC types 1 and 4 automatically set the mirroring to whatever the
  139. game needs, so do not use Ctrl to try to fix these games as it will not
  140. work.
  141.  
  142. Sprites don't appear - This should not happen anymore, but some games
  143. still may have problems with sprites. I only know of one, and it is 
  144. caused by timing problems that I am working on fixing.
  145.  
  146. Game doesn't work, or doesn't work correctly - darkNESs v0.24 is still an 
  147. early version, and many games still do not work (most of these are due
  148. to unsupported MMC's), and some games do not work correctly (these are 
  149. often caused by timing problems or by games using parts of the NES hardware
  150. that are not yet implimented (or not implemented correctly). I am working
  151. on making darkNESs as compatible as possible, but it will take time, so
  152. if a game doesn't work, wait until the next version comes out, and try it
  153. again.
  154.  
  155. Support darkNESs : 
  156.  
  157. I have decided to make darkNESs giftware. This means that if you use
  158. darkNESs and like it (or even if you use it and don't like it) that
  159. you should send me a gift. You are under no obligation to send me anything,
  160. but the more gifts that I recieve, the more incentive I will have to work
  161. on new versions, and the less incentive I will have to make darkNESs
  162. shareware (as the other NES emulators for the Amiga are).
  163.  
  164. Some suggested gifts are : 
  165.  
  166.     Money (Canadian or U.S. dollars only) - Money is always good...
  167.     Software/Hardware - If you have any old Amiga software or hardware
  168.                 that you no longer use,send it to me.
  169.     Registered Shareware - If you are the author of any Shareware for
  170.                    the Amiga, send me a registered copy.
  171.     PD/Freeware - If you have written any good PD or Freeware programs
  172.               send me a copy on disk.
  173.     Postcard - A cheap and easy gift.
  174.     E-Mail - If a postcard is out of your price range, then send me 
  175.          an E-Mail message.
  176.  
  177.  
  178. My address is : 
  179.  
  180.     Mark Van Hal
  181.     80 Delroy Dr.
  182.     Etobicoke, Ont.
  183.     Canada
  184.     M8Y-1N2
  185.  
  186.  
  187. My e-mail address is :
  188.  
  189. e0fkgkfo@mail.erin.utoronto.ca
  190.  
  191. NOTE : My ISP went out of business, so my old e-mail address
  192. (mongo@octonline.com) is no longer valid, also the darkNESs homepage
  193. no longer exists (a new one will be up at a new address shortly).
  194.  
  195. The Future : 
  196.  
  197. I plan on fixing bugs and adding new features to make darkNESs the best
  198. NES emulator available for any computer. 
  199.  
  200. Note : If anyone has any technical documentation on the NES (other than
  201. the ones by Marat Fayzullin and Y0SHI) please contact me by E-Mail.
  202.  
  203. Note : Do NOT send me E-Mail asking for ROM images or complaining that
  204. a game doesn't work, you will not get any ROM images from me, and I know
  205. about most games that don't work. Also don't send me e-mail asking me to
  206. send you the latest version of darkNESs, the latest version is always 
  207. available on AmiNet.
  208.  
  209. Credits : 
  210.  
  211. Marat Fayzullin - For the NES documentation and the 6502 emulation that
  212. was used in versions before 0.20
  213. Without which darkNESs would have taken much longer to develope.
  214.  
  215. Paul Robson - For releasing the source to NESA, his NES emulator for the PC,
  216. from which I borrowed (stole) the palette.
  217.  
  218. Craig Howard - For creating the icon for darkNESs.
  219.  
  220. Y0SHI - For his NESTECH.DOC which is a great source of info on the NES.
  221.  
  222. Mark Knibbs - For providing me with lots of useful bug reports and
  223. suggestions.
  224.  
  225. ...and several other people that have names that I can't remember.
  226.  
  227. "Yet when I hoped for good, evil came; when I looked for light, then
  228.    came darkNESs." - JOB 30:26
  229.  
  230.